home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 050a / peditpls.zip / TUTORIAL.DOC < prev    next >
Text File  |  1991-12-06  |  26KB  |  566 lines

  1.  
  2.  
  3.  
  4.  
  5.                     ╔══════════════════════════════════════╗
  6.                     ║                                      ║
  7.                     ║               pEDIT PLUS             ║
  8.                     ║          ───────────────────         ║
  9.                     ║          the personal EDITor         ║
  10.                     ║                                      ║
  11.                     ║                                      ║
  12.                     ║                TUTORIAL              ║
  13.                     ║                                      ║
  14.                     ║              Version  1.0            ║
  15.                     ║                                      ║
  16.                     ╚══════════════════════════════════════╝
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                         pEDIT COPYRIGHT 1989, 1990, 1991
  24.  
  25.  
  26.  
  27.                                _______
  28.                           ____|__     |                (R)
  29.                        --|       |    |-------------------
  30.                          |   ____|__  |  Association of
  31.                          |  |       |_|  Shareware
  32.                          |__|   o   |    Professionals
  33.                        -----|   |   |---------------------
  34.                             |___|___|    MEMBER
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                                   T. G. Muench
  49.                                  P.O. Box 11536
  50.                              Prescott, AZ 86304-1536
  51.                                  (602) 445-2479
  52.  
  53.                                  CIS 71171,2424
  54.  
  55.  
  56.  
  57.  
  58.             Welcome to the pEDIT PLUS tutorial. It is quite short
  59.         and covers only the basic text editing functions. You must
  60.         also read the manual, especially the Quick Start section.
  61.         You must use the STD (Standard) configuration while in the
  62.         tutorial. Later, you can, if you wish, change to one of the
  63.         other supplied configurations - or, set up your own.
  64.  
  65.             The purpose of this tutorial is to familiarize you with
  66.         the fundamentals of text editing. It is assumed that you
  67.         have a basic knowledge of the IBM PC and can operate the key-
  68.         board and mouse. If you have problems, consult your computer
  69.         and mouse manuals.
  70.  
  71.             The lessons primarily make use of the keyboard. However,
  72.         equivalent functions using the mouse and ButtonBar are given
  73.         when appropriate.
  74.  
  75.             Key names are enclosed in angle brackets; examples are
  76.         <Home>, <Ctrl-End> and <Alt-F>. The function keys are named
  77.         <F01> through <F12>; note that <F01> is the key marked F1.
  78.         The arrow keys are named <Up>, <Down>, <Left> and <Right>.
  79.         ButtonBar buttons are referenced by their text mode abbrev-
  80.         iations; examples are <CMD> and <FMT>.
  81.  
  82.             Two things need some explanation before you start the
  83.         tutorial. Both seem to cause much consternation for people
  84.         who are new to computing and text editing/word processing.
  85.         First, the <Enter> and <Tab> keys and <Space> bar operate
  86.         very differently than they do on a typewriter. On a type-
  87.         writer, they move you around on the page - they don't put
  88.         anything on the page. In pEDIT, <Enter> inserts a new line,
  89.         <Tab> inserts a tab character and the space bar inserts a
  90.         space (blank).
  91.  
  92.             Second, don't be afraid of hurting anything! You will be
  93.         working with copies of a practice file and can always get
  94.         the original back. When you start working with real text,
  95.         you can always go back to the point of the last save. Pay
  96.         heed to the First Law of Word Processing: "Save early, save
  97.         often".
  98.  
  99.             If you get 'lost', press <F01> to get on-line help for
  100.         every pEDIT command and <Alt-H> for keyboard and ButtonBar
  101.         help. If you get completely lost, quit the tutorial by
  102.         clicking on the <QUI> button or pressing <Alt-Q> (answer
  103.         "Y") and restart at the point where you had a problem.
  104.  
  105.             To start the tutorial, type in the following at the DOS
  106.         command line. If you installed pEDIT PLUS in a directory
  107.         other than \PEDIT, substitute that directory's name:
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.                 CD \PEDIT
  115.                 TUTORIAL
  116.  
  117.             The TUTORIAL batch file makes two copies of the file
  118.         PRACTICE.TXT called PRACTICE.1 and PRACTICE.2; it then
  119.         invokes the editor using the STD configuration and loads the
  120.         file PRACTICE.1 into memory. You are now ready to start the
  121.         lessons.
  122.  
  123.  
  124.                          ╔═════════════════════════════╗
  125.                          ║  Lesson 1: Cursor Movement  ║
  126.                          ╚═════════════════════════════╝
  127.  
  128.             Moving the cursor around in the text is among the most
  129.         basic of all editing functions. Start by using the arrow
  130.         keys to move up, down, left and right. The current line and
  131.         column indicators on the Status Bar will change as you move.
  132.  
  133.             Press <Ctrl-Home> to return to the top of the buffer.
  134.         Next, press the <End> key to move to the end of the first
  135.         line; press it several more times to move to the end of
  136.         subsequent lines. Now, use the <Home> key to move toward the
  137.         top of the buffer. Notice how the cursor moves to the begin-
  138.         ning of each line.
  139.  
  140.             Move back to the top of the buffer. Press <PgDn> to page
  141.         down to the next screen; press it once more and the cursor
  142.         will move to the end of the buffer. Pressing <PgUp> will
  143.         return you to the top. Now, press <Ctrl-End> which moves you
  144.         directly to the bottom.
  145.  
  146.             Now, move to the top of the buffer and press <Ctrl-
  147.         Right> to move a word at a time to the right. Then, try
  148.         <Ctrl-Left> to move by word backwards toward the top of the
  149.         buffer. pEDIT uses a macro (more on this later) to move in
  150.         Reverse; notice how the Direction shown on the Status Bar
  151.         changes from Forward to Reverse to Forward.
  152.  
  153.             If you have a mouse, practice clicking on the UpArrow
  154.         symbol at the top of the Scroll Bar to the right of the
  155.         screen. Note how the screen scrolls up one line at a time.
  156.         Next, click on the DownArrow at the bottom of the Scroll
  157.         Bar; the screen will scroll down one line at a time. Next,
  158.         click on the area between the DoubleArrow and the UpArrow or
  159.         DownArrow to page up or down. Finally, move the mouse
  160.         pointer anywhere in the window and press the left button to
  161.         move the text cursor to that spot.
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.                         ╔═══════════════════════════════╗
  172.                         ║  Lesson 2: Text Manipulation  ║
  173.                         ╚═══════════════════════════════╝
  174.  
  175.             The first Lesson showed you how to move around in a text
  176.         buffer. Moving the cursor is non-destructive; the buffer was
  177.         not modified.  In this lesson the buffer will be modified as
  178.         you insert and alter text.
  179.  
  180.             First, let's insert some text. This is what happens when
  181.         you press any one of the typing keys such as <A>, <Enter> or
  182.         <Tab>. Use the keys you learned about in the previous Lesson
  183.         to position the cursor on the comma after "March 30" on the
  184.         first line of the first paragraph. Making sure <Caps Lock>
  185.         is off, press the <T> and <H> keys to change "30" to "30th".
  186.         Notice how the text to the right of the cursor is shifted
  187.         over; the mode is Insert as shown on the Status Bar.
  188.  
  189.             Press the <Ins> key to toggle the mode to Overstrike.
  190.         Move the cursor to the "M" of "March" and type in "April".
  191.         Notice how "March" was changed to "April"; text was over-
  192.         written, not inserted. Press <Ins> again to return to Insert
  193.         mode.
  194.  
  195.             Now you will set the text margins and try reformatting a
  196.         paragraph. Make sure the Status Bar shows Insert mode and
  197.         press the <Esc> key to enter command mode. Type in "SET
  198.         MARGINS 10 70" (the case doesn't matter) and press <Enter>.
  199.         Now, position the text cursor anywhere on the line contain-
  200.         ing "April 30th" and press <Alt-F> to "fill" or reformat the
  201.         paragraph. Notice how the word "States" was moved down to
  202.         the next line; it no longer fit between the margins after
  203.         "th" was added.
  204.  
  205.             You can change a word (or part of a word) to lowercase,
  206.         UPPERCASE or Capitalized by using the <Alt-L>, <Alt-U> and
  207.         <Alt-C> keys, respectively. Try it.
  208.  
  209.             It is not possible to cover every pEDIT PLUS command in
  210.         the tutorial. Refer to the manual on your own and try the
  211.         CENTER LINE, OPEN LINE, INDENT, AUTO INDENT, QUOTE CHAR and
  212.         TRANS CHAR functions. You will also want to see what happens
  213.         when you insert tabs into the text.
  214.  
  215.  
  216.                           ╔═══════════════════════════╗
  217.                           ║  Lesson 3: Text Deletion  ║
  218.                           ╚═══════════════════════════╝
  219.  
  220.             In this Lesson you will practice deleting text. You can
  221.         delete by character, word or line. Note that the last word
  222.         or line erased is saved in a special text buffer so it can
  223.  
  224.  
  225.  
  226.  
  227.  
  228.         be restored if you so desire. This is called 'undo' by some
  229.         programs.
  230.  
  231.             First, let's put things back as they were; move to the
  232.         "t" of "30th" and press the <Del> key twice; the "th" will
  233.         be erased and the screen will again show "30". You can also
  234.         erase backwards by using the <BackSpace> key. Position the
  235.         cursor after the word "being" in the 2nd paragraph. Press
  236.         <BackSpace> 5 times to erase the word; now type "being" to
  237.         restore it.
  238.  
  239.             Next, move the cursor to the "b" of the word "being" and
  240.         press <Ctrl-D> to delete the word. Press <F05> to restore
  241.         it. Next, move to the beginning of the first line of that
  242.         paragraph starting with "Sportsmen". Press <Ctrl-K> to
  243.         "kill" the line; note that the entire line is deleted. Press
  244.         <F05> to restore it.
  245.  
  246.             Finally, move to the word "others" on that same line;
  247.         press <Ctrl-K> to erase all text from the cursor to the end
  248.         of the line. Pressing <F05> will restore the text.
  249.  
  250.  
  251.                             ╔═══════════════════════╗
  252.                             ║  Lesson 4: Searching  ║
  253.                             ╚═══════════════════════╝
  254.  
  255.             These commands are used to search for text and replace
  256.         one text string by another. Move to the top of the buffer
  257.         and click the <FND> button or press <Ctrl-F>. Enter "forest"
  258.         in response to the prompt "String to find: " and press the
  259.         <Enter> key. The cursor will move to the first occurrence of
  260.         "forest" and highlight it. Now, press the <F03> (FINDNEXT)
  261.         key several times until the message "Could not find text" is
  262.         displayed.
  263.  
  264.             This search was case-insensitive, that is it matched
  265.         every occurrence of "forest" no matter what the case. Return
  266.         to the top of the buffer and press <Ctrl-F> again; this time
  267.         press <Up> to restore "forest". Use the <Home> key to move
  268.         to the beginning of "forest" and press <Del> followed by an
  269.         uppercase F to change "forest" to "Forest". Press <Enter>
  270.         to initiate the search; this time, note that only the exact
  271.         text "Forest" is matched. Now click the <NXT> button or
  272.         press <F03> as above until the "Could not find text" message
  273.         appears.
  274.  
  275.             You're now ready to try replacing some text. Return to
  276.         the top of the buffer and click the <RPL> button or press
  277.         <Alt-R>. In response to the "Old string" prompt type in
  278.         "April" and press <Enter>; at the "New string" prompt type
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.         "March" followed by <Enter>. The cursor will move to "April"
  286.         and the prompt "Replace (Y)es (N)o (A)ll (L)ast (Q)uit: "
  287.         will appear. Press the "Y" key to accept the replacement.
  288.  
  289.             Please try the other responses on your own; "N" means do
  290.         not replace; "A" means replace all occurrences from this
  291.         point to the end; "L" means make this the last replacement
  292.         and quit; "Q" means quit now. Be careful of "A"; you won't
  293.         have a chance to pick and choose!
  294.  
  295.             pEDIT also supports wildcard searches; you can match the
  296.         beginning and end of line by using the special symbols \\<
  297.         and \\>, respectively. Lets try one; move back to the top by
  298.         pressing <Ctrl-Home>; press <Ctrl-F> and type in ".\\>"
  299.         followed by <Enter>. Notice how a match is made only if the
  300.         period is at the end of a line.
  301.  
  302.  
  303.                               ╔═══════════════════╗
  304.                               ║  Lesson 5: Files  ║
  305.                               ╚═══════════════════╝
  306.  
  307.             You are now ready for some more advanced functions. In
  308.         this Lesson you will learn how to load in a file for edit-
  309.         ing, and save a modified buffer to disk.
  310.  
  311.             First, "get" a file by clicking on the <GET> button or
  312.         pressing <Alt-G>, typing in PRACTICE.2 and pressing <Enter>.
  313.         This file, a duplicate of PRACTICE.1, will be loaded into
  314.         memory and will become the current buffer. Its name will
  315.         appear on the Status Bar. pEDIT PLUS will let you edit up to
  316.         16 files at one time.
  317.  
  318.             Now, lets save the current buffer to disk. Click the
  319.         <WRT> button or press <F10>, which is the WRITE FILE key.
  320.         Nothing happened because, as the message tells you, the
  321.         buffer has not been modified. pEDIT will not save a buffer
  322.         that hasn't changed. You should still be positioned at the
  323.         top of the buffer; press <Del> to delete the first (empty)
  324.         line. Now press <F10>; this time the modified buffer is
  325.         saved to disk and pEDIT will tell you how many lines were
  326.         written.
  327.  
  328.             There are two other file commands which you can try on
  329.         your own. The first is INCLUDE FILE which inserts the text
  330.         from a file on disk into the buffer starting at the current
  331.         cursor position. This command should be used only to 'merge'
  332.         in relatively small files. RENAME FILE is used to change the
  333.         name of the disk file associated with the buffer; use this
  334.         command when you want to save a file under a different name
  335.         and preserve the original.
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.                              ╔═════════════════════╗
  343.                              ║  Lesson 6: Buffers  ║
  344.                              ╚═════════════════════╝
  345.  
  346.             These functions let you choose a buffer to edit, display
  347.         information about the current buffer and change the mode and
  348.         direction for a buffer.
  349.  
  350.             Click the info button <INF> or press <Esc> and type in
  351.         "SHOW BUFFER". A SHOW window will appear which displays
  352.         information about the current buffer: its name, associated
  353.         file name, whether or not it has been modified, the current
  354.         direction and mode, etc. Press any key or click a mouse
  355.         button to return to the buffer you were editing.
  356.  
  357.             You have two active buffers (PRACTICE.1 and PRACTICE.2)
  358.         loaded. To switch back to the first buffer, click the <BUF>
  359.         button or press <F02> and highlight PRACTICE.1 by using the
  360.         arrow keys or, if you have a mouse, clicking on the buffer
  361.         name. Then, press <Enter> or click the right mouse button to
  362.         move to the selected buffer.
  363.  
  364.             pEDIT supports marks, sometimes called bookmarks. You
  365.         can set one mark per buffer and use the GOTO MARK command to
  366.         immediately move to that spot from anywhere in the buffer.
  367.         Let's try it. Move to the top of the buffer and use <Ctrl-F>
  368.         to locate the word "Organic". Press <Esc> and type in "MARK"
  369.         to mark this location. Use <PgUp> to move to the top of the
  370.         buffer and then issue the command "GOTO MARK".
  371.  
  372.             Please try these remaining commands on your own. The
  373.         LINE command moves the cursor to a particular line in a buf-
  374.         fer. TRIM BUFFER deletes all trailing blanks from each line
  375.         in the current buffer. CHANGE MODE toggles the mode between
  376.         Insert and Overstrike, and CHANGE DIR toggles the direction.
  377.  
  378.  
  379.                              ╔═════════════════════╗
  380.                              ║  Lesson 7: Windows  ║
  381.                              ╚═════════════════════╝
  382.  
  383.             In this Lesson you will learn how to split and unsplit
  384.         the screen, move from window to window when the screen is
  385.         split, and shift a window horizontally.
  386.  
  387.             There is now a single window on screen; click on the
  388.         <TWO> button or press <Alt-2> to split the screen into 2
  389.         windows. The cursor will move to the second window. Notice
  390.         that both windows are into the same buffer (PRACTICE.1) and
  391.         show the same portion of text. Now, using what you learned
  392.         in the previous Lesson, switch to the buffer PRACTICE.2 in
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.         the bottom window.
  400.  
  401.             You should now have PRACTICE.1 displayed in the top
  402.         window, and PRACTICE.2 in the bottom window. You move to the
  403.         other window by - you guessed it - the OTHER WINDOW command.
  404.         Press <F04> to move back and forth between the two windows.
  405.         If you have a mouse, simply click the left button anywhere
  406.         in the other window.
  407.  
  408.             The <PgUp> and <PgDn> keys were discussed in the first
  409.         lesson; they move you around VERTICALLY in the buffer and
  410.         always show the same 78 columns of text. You can also move
  411.         horizontally using the SHIFT commands. This is called horiz-
  412.         ontal scrolling; it lets you see text beyond the right edge
  413.         of the screen.
  414.  
  415.             Move to the PRACTICE.2 buffer and click the <ONE> button
  416.         or press <Alt-1> to unsplit the screen. Press <Alt-M> and
  417.         set the margins to 1 and 128. Then, position the cursor any-
  418.         where on the first line of the first paragraph and click the
  419.         <FMT> button or press <Alt-F> to "fill" or reformat the
  420.         paragraph. Note that the paragraph has become 2 long lines,
  421.         each longer than 78 columns. The cursor is positioned at the
  422.         right edge of the window to indicate that text extends past
  423.         this point. The current location on the Status Bar indicates
  424.         the 'real' position of the cursor.
  425.  
  426.             Click on the rightmost button or Press <Esc> to enter
  427.         command mode and type in "SHIFT RIGHT". You can now see past
  428.         column 78, but not to the end of the first line. Issue the
  429.         command again - by pressing <Esc> followed by <Up> - to view
  430.         columns 80->. Finally, click the leftmost button twice or
  431.         issue the command "SHIFT LEFT 80" and press <Home> to return
  432.         to the left edge of the buffer.
  433.  
  434.  
  435.                           ╔═══════════════════════════╗
  436.                           ║  Lesson 8: Cut and Paste  ║
  437.                           ╚═══════════════════════════╝
  438.  
  439.             This lesson will cover electronic "cut" and "paste". You
  440.         can delete (cut) a portion of text and store it in a special
  441.         buffer for later use. The contents of this buffer (called
  442.         the paste buffer or clipboard) can then be "pasted" into the
  443.         current buffer wherever it is needed.
  444.  
  445.             Text must be selected before it can be cut or copied to
  446.         the clipboard. The SELECT TEXT command is a toggle which
  447.         turns the select state on and off. In this exercise, you
  448.         will select the first paragraph, 'cut' it to the clipboard,
  449.         and then paste it in after the second paragraph.
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.             First, put the first paragraph back as it was. Set the
  457.         text margins to 10 and 70 and reformat the paragraph using
  458.         <Alt-F>. Next, position the cursor back to the first line of
  459.         the paragraph at the far left edge of the window. Press <Alt-
  460.         S> to turn select on and use the <Down> key to highlight
  461.         each line of the paragraph. Be sure and include the blank
  462.         line in between the paragraphs; you should end up with the
  463.         cursor at the beginning of the first line of the second para-
  464.         graph.
  465.  
  466.             Now, click the <CUT> button or press <Alt-D> to 'cut'
  467.         the paragraph. Move the text cursor to the start of the
  468.         paragraph that begins "With the Creation Act". Click on
  469.         <PST> or press <Alt-P> to 'paste' in the stored text; the
  470.         first and second paragraphs have been swapped.
  471.  
  472.             There are two other commands which use select; please
  473.         try them on your own. The first is WIPE TEXT, which deletes
  474.         text without saving it on the clipboard. Use this command
  475.         when you want to delete a large amount of text and don't
  476.         need it back. STORE TEXT copies the highlighted text to the
  477.         clipboard but does not delete it from the buffer.
  478.  
  479.  
  480.                            ╔════════════════════════╗
  481.                            ║  Lesson 9: Key Macros  ║
  482.                            ╚════════════════════════╝
  483.  
  484.             This is an advanced topic and won't be covered in any
  485.         detail here. Please read the appropriate sections in the
  486.         manual for instructions on how to set up both key and disk
  487.         macros. There are commands to start/end a learn sequence,
  488.         and execute a macro.
  489.  
  490.             A key macro is one that is used infrequently, i.e. a
  491.         'one shot' deal. If you have a macro that you use all of the
  492.         time, it should be saved to disk and given a name.
  493.  
  494.             You saw a disk macro in operation in Lesson 1. The <Ctrl-
  495.         Left> key is bound to the command EXECUTE STDWREV. When you
  496.         press <Ctrl-Left>, pEDIT loads in the macro file STDWREV.PMC
  497.         from disk and 'plays back' the keystrokes it contains.
  498.  
  499.  
  500.                          ╔════════════════════════════╗
  501.                          ║  Lesson 10: Miscellaneous  ║
  502.                          ╚════════════════════════════╝
  503.  
  504.             Many commands fall into the miscellaneous category. We
  505.         can't cover all of them here; please refer to the manual for
  506.         more information. As you read this, you may want to try some
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.         of them.
  514.  
  515.             One command you need to know about is ABORT. It *must*
  516.         be bound to a key because you won't be able to get to the
  517.         command line when you need to use it. You can ABORT out of
  518.         any FIND, FINDNEXT, REPLACE or REPEAT operation.
  519.  
  520.             ABORT can also be used to cancel a selection in any
  521.         BUFFER, FILES or HELP window. You can try this by clicking
  522.         the <HLP> button or pressing <F01>; instead of selecting a
  523.         help topic, press <Ctrl-C>. Note that you are returned to
  524.         the current buffer.
  525.  
  526.             REPEAT is a very handy function that lets you repeat any
  527.         keypress up to 32767 times. As a quick test, press <F08> and
  528.         enter a repeat count of 44; DO NOT press <Enter> after the
  529.         count or 44 blank lines will be entered! Press the <Right>
  530.         key and watch the cursor move 44 characters to the right.
  531.  
  532.             There are many SET commands you can use to customize the
  533.         editing environment. You can automatically save your work to
  534.         disk, choose foreground and background colors, set the
  535.         number of lines on-screen in text mode, set the paragraph
  536.         indent, and set the scope for search and replace operations.
  537.  
  538.             The DOS command lets you shell out to DOS or pass a com-
  539.         mand to DOS for execution. The output from a shelled DOS
  540.         command goes into the DOS buffer where it can be viewed and
  541.         manipulated like any other text.
  542.  
  543.             Now, click the <CMD> button or press the <Esc> key to
  544.         enter Command Mode and type in "LIST KEYS" followed by
  545.         <Enter>. You will see a list of all defined keys and the
  546.         command bound to each in a LIST window.
  547.  
  548.             The <F01> (HELP) key brings up an indexed list of all
  549.         pEDIT+ commands; there is also a <HLP> button. <Alt-H>
  550.         (ALTHELP) displays special help screens for the keyboard and
  551.         ButtonBar. Try both of these keys now if you haven't already
  552.         done so.
  553.  
  554.             Finally, there are two ways to end an editing session.
  555.         The first is QUIT; use it when you want to abort without
  556.         saving any modified buffers. EXIT, on the other hand, auto-
  557.         matically saves the current buffer to disk if it has been
  558.         modified and asks you, one at a time, if you want to save
  559.         any other modified buffers.
  560.  
  561.                      ---------------------------------------
  562.  
  563.             This concludes the tutorial. QUIT by pressing the <Alt-
  564.         Q> key. Enter "Y" in response to the "Buffer (s) modified -
  565.         quit (Y/N)?" prompt.
  566.